package com.zhang.common.core.utils.poi;

import cn.hutool.core.convert.Convert;
import com.zhang.common.core.annotation.Excel;
import com.zhang.common.core.annotation.Excels;
import com.zhang.common.core.utils.DateUtils;
import com.zhang.common.core.utils.StringUtils;
import com.zhang.common.core.utils.file.FileTypeUtils;
import com.zhang.common.core.utils.file.ImageUtils;
import com.zhang.common.core.utils.reflect.ReflectUtils;
import jakarta.servlet.http.HttpServletResponse;
import org.apache.commons.lang3.RegExUtils;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.ss.util.CellRangeAddress;
import org.apache.poi.ss.util.CellRangeAddressList;
import org.apache.poi.util.IOUtils;
import org.apache.poi.xssf.streaming.SXSSFWorkbook;
import org.apache.poi.xssf.usermodel.XSSFClientAnchor;
import org.apache.poi.xssf.usermodel.XSSFDataValidation;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.io.InputStream;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.math.BigDecimal;
import java.text.DecimalFormat;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.*;
import java.util.stream.Collectors;

/**
 * @Class com.zhang.common.core.utils.poi
 * @Author zhang
 * @Date 2025/9/10 15:52
 * @Description Excel相关处理工具类
 **/
public class ExcelUtil<T> {

    /**
     * 日志打印
     */
    private static final Logger log = LoggerFactory.getLogger(ExcelUtil.class);

    /**
     * 特殊字符表达式
     */
    public static final String FORMULA_REGEX_STR = "=|-|\\+|@";

    /**
     * 特殊字符数组
     */
    public static final String[] FORMULA_STR = {"=", "-", "+", "@"};


    /**
     * Excel sheet最大行数，默认65536
     */
    public static final int sheetSize = 65536;

    /**
     * 工作表名称
     */
    private String sheetName;

    /**
     * 导出类型（EXPORT:导出数据；IMPORT：导入模板）
     */
    private Excel.Type type;

    /**
     * 工作薄对象
     */
    private Workbook wb;

    /**
     * 工作表对象
     */
    private Sheet sheet;

    /**
     * 样式列表
     */
    private Map<String, CellStyle> styles;

    /**
     * 导入导出数据列表
     */
    private List<T> list;

    /**
     * 注解列表
     */
    private List<Object[]> fields;

    /**
     * 当前行号
     */
    private int rowNum;

    /**
     * 标题
     */
    private String title;

    /**
     * 最大高度
     */
    private short maxHeight;

    /**
     * 统计列表
     */
    private Map<Integer, Double> statistics = new HashMap<>();

    /**
     * 数字格式
     */
    private static final DecimalFormat DOUBLE_FORMAT = new DecimalFormat("######0.00");

    /**
     * 实体对象
     */
    public Class<T> clazz;

    /**
     * 构造函数初始化实体对象
     *
     * @param clazz 初始化的实体对象
     */
    public ExcelUtil(Class<T> clazz) {
        this.clazz = clazz;
    }

    /**
     * 初始化 Excel 表格
     *
     * @param list      导入|导出数据集
     * @param sheetName 工作表名称
     * @param title     标题
     * @param type      EXPORT: 导出数据 | IMPORT: 导入模板
     */
    public void init(List<T> list, String sheetName, String title, Excel.Type type) {
        // 数据判空
        if (list == null) {
            list = new ArrayList<T>();
        }
        this.list = list;
        this.sheetName = sheetName;
        this.type = type;
        this.title = title;
        createExcelField();
        createWorkbook();
        createTitle();
    }

    /**
     * 得到所有定义字段
     */
    private void createExcelField() {
        this.fields = getFields();
        this.fields = this.fields.stream().sorted(Comparator.comparing(objects -> ((Excel) objects[1]).sort())).collect(Collectors.toList());
        this.maxHeight = getRowHeight();
    }

    /**
     * 获取字段注解信息
     */
    public List<Object[]> getFields() {
        List<Object[]> fields = new ArrayList<>();
        List<Field> tempFields = new ArrayList<>();
        tempFields.addAll(Arrays.asList(clazz.getSuperclass().getDeclaredFields()));
        tempFields.addAll(Arrays.asList(clazz.getDeclaredFields()));
        for (Field field : tempFields) {
            // 单注解
            if (field.isAnnotationPresent(Excel.class)) {
                Excel attr = field.getAnnotation(Excel.class);
                if (attr != null && (attr.type() == Excel.Type.ALL || attr.type() == type)) {
                    field.setAccessible(true);
                    fields.add(new Object[]{field, attr});
                }
            }

            // 多注解
            if (field.isAnnotationPresent(Excels.class)) {
                Excels attrs = field.getAnnotation(Excels.class);
                Excel[] excels = attrs.value();
                for (Excel attr : excels) {
                    if (attr != null && (attr.type() == Excel.Type.ALL || attr.type() == type)) {
                        field.setAccessible(true);
                        fields.add(new Object[]{field, attr});
                    }
                }
            }
        }
        return fields;
    }

    /**
     * 根据注解获取最大行高
     */
    public short getRowHeight() {
        double maxHeight = 0;
        for (Object[] os : this.fields) {
            Excel excel = (Excel) os[1];
            maxHeight = Math.max(maxHeight, excel.height());
        }
        return (short) (maxHeight * 20);
    }


    /**
     * 创建一个工作簿
     */
    public void createWorkbook() {
        this.wb = new SXSSFWorkbook(500);
        this.sheet = wb.createSheet();
        wb.setSheetName(0, sheetName);
        this.styles = createStyles(wb);
    }

    /**
     * 创建表格样式
     *
     * @param wb 工作薄对象
     * @return 样式列表
     */
    private Map<String, CellStyle> createStyles(Workbook wb) {
        // 写入各条记录, 每条记录对应 excel 表中的一行
        Map<String, CellStyle> styles = new HashMap<>();

        // 标题单元格样式
        styles.put("title", setTitle(wb));

        // 数据单元格样式
        styles.put("data", setData(wb));

        // 头部单元格样式
        styles.put("header", setHeader(wb));

        // 总数单元格样式
        styles.put("total", setTotal(wb));

        // Excel 注解创建表格样式
        styles.putAll(annotationStyles(wb));

        return styles;
    }

    /**
     * 标题单元格样式
     *
     * @param wb Excel 表格数据
     * @return 返回标题样式
     */
    private CellStyle setTitle(Workbook wb) {
        // 标题单元格样式
        CellStyle style = wb.createCellStyle();
        // 水平垂直居中
        style.setAlignment(HorizontalAlignment.CENTER);
        style.setVerticalAlignment(VerticalAlignment.CENTER);
        // 字体样式
        Font titleFont = wb.createFont();
        titleFont.setFontName("Arial");
        titleFont.setFontHeightInPoints((short) 16);
        titleFont.setBold(true);
        style.setFont(titleFont);
        return style;
    }

    /**
     * 数据单元格样式
     *
     * @param wb Excel 表格数据
     * @return 返回单元格数据样式
     */
    private CellStyle setData(Workbook wb) {
        CellStyle style = wb.createCellStyle();
        style.setAlignment(HorizontalAlignment.CENTER);
        style.setVerticalAlignment(VerticalAlignment.CENTER);
        style.setBorderRight(BorderStyle.THIN);
        style.setRightBorderColor(IndexedColors.GREY_50_PERCENT.getIndex());
        style.setBorderLeft(BorderStyle.THIN);
        style.setLeftBorderColor(IndexedColors.GREY_50_PERCENT.getIndex());
        style.setBorderTop(BorderStyle.THIN);
        style.setTopBorderColor(IndexedColors.GREY_50_PERCENT.getIndex());
        style.setBorderBottom(BorderStyle.THIN);
        style.setBottomBorderColor(IndexedColors.GREY_50_PERCENT.getIndex());
        Font dataFont = wb.createFont();
        dataFont.setFontName("Arial");
        dataFont.setFontHeightInPoints((short) 10);
        style.setFont(dataFont);
        return style;
    }

    /**
     * 头部单元格样式
     *
     * @param wb Excel 表格数据
     * @return 返回单元格数据头部样式
     */
    private CellStyle setHeader(Workbook wb) {
        CellStyle style = wb.createCellStyle();
        style.cloneStyleFrom(styles.get("data"));
        style.setAlignment(HorizontalAlignment.CENTER);
        style.setVerticalAlignment(VerticalAlignment.CENTER);
        style.setFillForegroundColor(IndexedColors.GREY_50_PERCENT.getIndex());
        style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
        Font headerFont = wb.createFont();
        headerFont.setFontName("Arial");
        headerFont.setFontHeightInPoints((short) 10);
        headerFont.setBold(true);
        headerFont.setColor(IndexedColors.WHITE.getIndex());
        style.setFont(headerFont);
        return style;
    }

    /**
     * 总数单元格样式
     *
     * @param wb Excel 表格数据
     * @return 返回单元格数据总数样式
     */
    private CellStyle setTotal(Workbook wb) {
        CellStyle style = wb.createCellStyle();
        style.setAlignment(HorizontalAlignment.CENTER);
        style.setVerticalAlignment(VerticalAlignment.CENTER);
        Font totalFont = wb.createFont();
        totalFont.setFontName("Arial");
        totalFont.setFontHeightInPoints((short) 10);
        style.setFont(totalFont);
        return style;
    }

    /**
     * 创建工作表
     *
     * @param sheetNo sheet数量
     * @param index   序号
     */
    public void createSheet(int sheetNo, int index) {
        // 设置工作表的名称.
        if (sheetNo > 1 && index > 0) {
            this.sheet = wb.createSheet();
            this.createTitle();
            wb.setSheetName(index, sheetName + index);
        }
    }

    /**
     * 根据 Excel 注解创建表格样式
     *
     * @param wb 工作薄对象
     * @return 自定义样式列表
     */
    private Map<String, CellStyle> annotationStyles(Workbook wb) {
        Map<String, CellStyle> styles = new HashMap<>();
        for (Object[] os : fields) {
            Excel excel = (Excel) os[1];
            String key = "data_" + excel.align() + "_" + excel.color();
            if (!styles.containsKey(key)) {
                CellStyle style = setData(wb);
                style.setAlignment(excel.align());
                Font dataFont = wb.createFont();
                dataFont.setFontName("Arial");
                dataFont.setFontHeightInPoints((short) 10);
                dataFont.setColor(excel.color().index);
                style.setFont(dataFont);
                styles.put(key, style);
            }
        }
        return styles;
    }


    /**
     * 创建 excel 第一行标题
     */
    public void createTitle() {
        if (StringUtils.isNotEmpty(title)) {
            Row titleRow = sheet.createRow(rowNum == 0 ? rowNum++ : 0);
            titleRow.setHeightInPoints(30);
            Cell titleCell = titleRow.createCell(0);
            titleCell.setCellStyle(styles.get("title"));
            titleCell.setCellValue(title);
            sheet.addMergedRegion(new CellRangeAddress(titleRow.getRowNum(), titleRow.getRowNum(), titleRow.getRowNum(),
                    this.fields.size() - 1));
        }
    }

    /**
     * 创建单元格
     *
     * @param attr   注解对象
     * @param row    行对象
     * @param column 列数
     */
    public void createCell(Excel attr, Row row, int column) {
        // 创建列
        Cell cell = row.createCell(column);
        // 写入列信息
        cell.setCellValue(attr.name());
        setDataValidation(attr, row, column);
        cell.setCellStyle(styles.get("header"));
    }

    /**
     * 创建表格样式
     *
     * @param attr   注解对象
     * @param row    行对象
     * @param column 列数
     */
    public void setDataValidation(Excel attr, Row row, int column) {
        // 注解名称包含指定字符时
        if (attr.name().contains("注：")) {
            sheet.setColumnWidth(column, 6000);
        } else {
            // 设置列宽
            sheet.setColumnWidth(column, (int) ((attr.width() + 0.72) * 256));
        }
        // 提示信息|只能选择不能输入的列内容限制判空
        if (StringUtils.isNotEmpty(attr.prompt()) || attr.combo().length > 0) {
            // 提示信息或只能选择不能输入的列内容
            setPromptOrValidation(sheet, attr.combo(), attr.prompt(), 1, 100, column, column);
        }
    }

    /**
     * 设置 POI XSSFSheet 单元格提示或选择框
     *
     * @param sheet         表单
     * @param textList      下拉框显示的内容
     * @param promptContent 提示内容
     * @param firstRow      开始行
     * @param endRow        结束行
     * @param firstCol      开始列
     * @param endCol        结束列
     */
    public void setPromptOrValidation(Sheet sheet, String[] textList, String promptContent,
                                      int firstRow, int endRow,
                                      int firstCol, int endCol) {
        // 数据校验规则类定义
        DataValidationHelper helper = sheet.getDataValidationHelper();
        // 实际校验方法对象
        DataValidationConstraint constraint = textList.length > 0 ? helper.createExplicitListConstraint(textList) : helper.createCustomConstraint("DD1");
        // 单元格区域校验对象
        CellRangeAddressList regions = new CellRangeAddressList(firstRow, endRow, firstCol, endCol);
        // 单元格区域数据校验对象
        DataValidation dataValidation = helper.createValidation(constraint, regions);
        // 提示内容判空
        if (StringUtils.isNotEmpty(promptContent)) {
            // 如果设置了提示信息则鼠标放上去提示
            dataValidation.createPromptBox("", promptContent);
            dataValidation.setShowPromptBox(true);
        }
        // 处理 Excel 兼容性问题
        if (dataValidation instanceof XSSFDataValidation) {
            dataValidation.setSuppressDropDownArrow(true);
            dataValidation.setShowErrorBox(true);
        } else {
            dataValidation.setSuppressDropDownArrow(false);
        }
        sheet.addValidationData(dataValidation);
    }

    /**
     * 获取单元格值
     *
     * @param row    获取的行
     * @param column 获取单元格列号
     * @return 单元格值
     */
    public Object getCellValue(Row row, int column) {
        // 行数判空
        if (!isRowEmpty(row)) {
            return "";
        }
        // 对应单元格默认值
        Object val = "";
        try {
            // 获取对应单元格
            Cell cell = row.getCell(column);
            // 单元格判空
            if (StringUtils.isNotNull(cell)) {
                // 数值是否为数值
                if (cell.getCellType() == CellType.NUMERIC || cell.getCellType() == CellType.FORMULA) {
                    // 转为对应的数值
                    val = cell.getNumericCellValue();
                    // 是否为日期格式数值
                    if (DateUtil.isCellDateFormatted(cell)) {
                        // POI Excel 日期格式转换
                        val = DateUtil.getJavaDate((Double) val);
                    } else {
                        // 转为对应的数值 - 非日期数值
                        if ((Double) val % 1 != 0) {
                            val = new BigDecimal(val.toString());
                        } else {
                            val = new DecimalFormat("0").format(val);
                        }
                    }
                } else if (cell.getCellType() == CellType.STRING) {
                    // 字符串数值
                    val = cell.getStringCellValue();
                } else if (cell.getCellType() == CellType.BOOLEAN) {
                    // 布尔数值
                    val = cell.getBooleanCellValue();
                } else if (cell.getCellType() == CellType.ERROR) {
                    // 。。。
                    val = cell.getErrorCellValue();
                }

            }
        } catch (Exception e) {
            log.error("第 {} 列单元格获取单元格值异常: {}", column, e.getMessage());
            return val;
        }
        return val;
    }

    /**
     * 判断是否是空行
     *
     * @param row 判断的行
     * @return 返回判断结果
     */
    private boolean isRowEmpty(Row row) {
        // 行数判空
        if (row == null) {
            return true;
        }
        // 获取行数
        for (int i = row.getFirstCellNum(); i < row.getLastCellNum(); i++) {
            // 获取每列数值
            Cell cell = row.getCell(i);
            // 每列数值判空 - 只要有一列不为空就返回
            if (cell != null && cell.getCellType() != CellType.BLANK) {
                return false;
            }
        }
        return true;
    }

    /**
     * 格式化不同类型的日期对象
     *
     * @param dateFormat 日期格式
     * @param val        被格式化的日期对象
     * @return 格式化后的日期字符
     */
    public String parseDateToStr(String dateFormat, Object val) {
        // 格式日期判空
        if (val == null) {
            return "";
        }
        String str;
        // 是否为 Date 类及其子类
        if (val instanceof Date) {
            str = DateUtils.parseDateToStr(dateFormat, (Date) val);
        } else if (val instanceof LocalDateTime) {
            // 是否为 LocalDateTime 类及其子类
            str = DateUtils.parseDateToStr(dateFormat, DateUtils.toDate((LocalDateTime) val));
        } else if (val instanceof LocalDate) {
            // 是否为 LocalDate 类及其子类
            str = DateUtils.parseDateToStr(dateFormat, DateUtils.toDate((LocalDate) val));
        } else {
            str = val.toString();
        }
        return str;
    }

    // ======================================== Excel 导入相关方法  ===================================================

    /**
     * 对excel表单默认第一个索引名转换成list
     *
     * @param is 输入流
     * @return 转换后集合
     */
    public List<T> importExcel(InputStream is) throws Exception {
        return importExcel(is, 0);
    }

    /**
     * 对 excel 表单默认第一个索引名转换成list
     *
     * @param is       输入流
     * @param titleNum 标题占用行数
     * @return 转换后集合
     */
    public List<T> importExcel(InputStream is, int titleNum) throws Exception {
        return importExcel(StringUtils.EMPTY, is, titleNum);
    }

    /**
     * 对excel表单指定表格索引名转换成list
     *
     * @param sheetName 表格索引名
     * @param titleNum  标题占用行数
     * @param is        输入流
     * @return 转换后集合
     */
    public List<T> importExcel(String sheetName, InputStream is, int titleNum) throws Exception {
        // 指定导入类型
        this.type = Excel.Type.IMPORT;
        this.wb = WorkbookFactory.create(is);
        List<T> list = new ArrayList<>();
        // 如果指定sheet名, 则取指定sheet中的内容 - 否则默认指向第1个sheet
        Sheet sheet = StringUtils.isNotEmpty(sheetName) ? wb.getSheet(sheetName) : wb.getSheetAt(0);
        if (sheet == null) {
            log.info("文件sheet不存在");
            throw new IOException("文件sheet不存在");
        }

        // 获取最后一个非空行的行下标, 比如总行数为 n，则返回的为 n-1
        int rows = sheet.getLastRowNum();

        // 行下标大于零时
        if (rows > 0) {
            // 定义一个 map 用于存放 excel 列的序号和 field
            Map<String, Integer> cellMap = new HashMap<>();
            // 获取表头 - 默认第一行
            Row header = sheet.getRow(titleNum);
            // 遍历列数
            for (int i = 0; i < header.getPhysicalNumberOfCells(); i++) {
                // 获取每列单元格
                Cell cell = header.getCell(i);
                // 单元格不为空
                if (StringUtils.isNotNull(cell)) {
                    // 获取单元格数值
                    String value = this.getCellValue(header, i).toString();
                    cellMap.put(value, i);
                } else {
                    // 单元格没有名称时
                    cellMap.put(null, i);
                }
            }
            // 有数据时才处理 得到类的所有 field (属性)
            List<Object[]> fields = this.getFields();
            Map<Integer, Object[]> fieldsMap = new HashMap<>();
            for (Object[] objects : fields) {
                Excel attr = (Excel) objects[1];
                // 通过属性名称获取对应的所在列数
                Integer column = cellMap.get(attr.name());
                if (column != null) {
                    fieldsMap.put(column, objects);
                }
            }
            // 遍历行数
            for (int i = titleNum + 1; i <= rows; i++) {
                // 从第2行开始取数据, 默认第一行是表头
                Row row = sheet.getRow(i);
                // 判断当前行是否是空行
                if (isRowEmpty(row)) {
                    continue;
                }
                T entity = null;
                // 遍历行数据对象
                for (Map.Entry<Integer, Object[]> entry : fieldsMap.entrySet()) {
                    // 获取当前行数据对应列的数值
                    Object val = this.getCellValue(row, entry.getKey());

                    // 如果不存在实例则新建
                    entity = (entity == null ? clazz.newInstance() : entity);
                    // 从 map 中得到对应列的 field (属性)
                    Field field = (Field) entry.getValue()[0];
                    // 注解属性值
                    Excel attr = (Excel) entry.getValue()[1];
                    // 取得类型, 并根据对象类型设置值
                    Class<?> fieldType = field.getType();
                    // 是否为字符串类型
                    if (String.class == fieldType) {
                        // 转为字符串
                        String s = Convert.toStr(val);
                        // 是否以 .0 结尾
                        if (StringUtils.endsWith(s, ".0")) {
                            // 去除 .0
                            val = StringUtils.substringBefore(s, ".0");
                        } else {
                            // 根据日期格式注解进行数据获取
                            String dateFormat = field.getAnnotation(Excel.class).dateFormat();
                            // 判空
                            if (StringUtils.isNotEmpty(dateFormat)) {
                                // 转为对应的日期格式数据
                                val = parseDateToStr(dateFormat, val);
                            } else {
                                val = Convert.toStr(val);
                            }
                        }
                    } else if ((Integer.TYPE == fieldType || Integer.class == fieldType) && StringUtils.isNumeric(Convert.toStr(val))) {
                        // 整形数据
                        val = Convert.toInt(val);
                    } else if ((Long.TYPE == fieldType || Long.class == fieldType) && StringUtils.isNumeric(Convert.toStr(val))) {
                        // 长整型数据
                        val = Convert.toLong(val);
                    } else if (Double.TYPE == fieldType || Double.class == fieldType) {
                        // 双精度浮点型数据
                        val = Convert.toDouble(val);
                    } else if (Float.TYPE == fieldType || Float.class == fieldType) {
                        // 单精度浮点型数据
                        val = Convert.toFloat(val);
                    } else if (BigDecimal.class == fieldType) {
                        // 精确浮点型数据
                        val = Convert.toBigDecimal(val);
                    } else if (Date.class == fieldType) {
                        // 日期类型数据 - 字符串时
                        if (val instanceof String) {
                            // 转为对应的日期格式数据
                            val = DateUtils.parseDate(val);
                        } else if (val instanceof Double) {
                            // 双精度数据时 - 转为对应日期数据
                            val = DateUtil.getJavaDate((Double) val);
                        }
                    } else if (Boolean.TYPE == fieldType || Boolean.class == fieldType) {
                        // 布尔型数据
                        val = Convert.toBool(val, false);
                    }

                    // 获取到的数据值判空
                    if (StringUtils.isNotNull(val)) {
                        // 字段名称
                        String propertyName = field.getName();
                        // 注解属性值后缀
                        if (StringUtils.isNotEmpty(attr.targetAttr())) {
                            propertyName = field.getName() + "." + attr.targetAttr();
                        } else if (StringUtils.isNotEmpty(attr.readConverterExp())) {
                            // 注解属性值反解析
                            val = reverseByExp(Convert.toStr(val), attr.readConverterExp(), attr.separator());
                        } else if (!attr.handler().equals(ExcelHandlerAdapter.class)) {
                            // 注解属性值调用格式转换方法获取值
                            val = dataFormatHandlerAdapter(val, attr);
                        }
                        ReflectUtils.invokeSetter(entity, propertyName, val);
                    }
                }
                list.add(entity);
            }
        }
        return list;
    }

    /**
     * 反向解析值 男=0,女=1,未知=2
     *
     * @param propertyValue 参数值
     * @param converterExp  翻译注解
     * @param separator     分隔符
     * @return 解析后值
     */
    public static String reverseByExp(String propertyValue, String converterExp, String separator) {
        StringBuilder propertyString = new StringBuilder();
        // 注解数据集
        String[] convertSource = converterExp.split(",");
        // 遍历注解数据集
        for (String item : convertSource) {
            // 获取注解值对应数据的数据集
            String[] itemArray = item.split("=");
            // 对应的参数值是否包含指定分隔符
            if (StringUtils.containsAny(separator, propertyValue)) {
                // 遍历参数值通过指定分隔符获取的数据集
                for (String value : propertyValue.split(separator)) {
                    // 注解值对应的值与数据集值是否匹配
                    if (itemArray[1].equals(value)) {
                        // 匹配时将对应的注解对应值与分隔符都添加到字符串中去
                        propertyString.append(itemArray[0]).append(separator);
                        break;
                    }
                }
            } else {
                // 否则直接判断是否匹配
                if (itemArray[1].equals(propertyValue)) {
                    // 匹配后直接添加即可
                    return itemArray[0];
                }
            }
        }
        return StringUtils.stripEnd(propertyString.toString(), separator);
    }

    /**
     * 数据处理器
     *
     * @param value 数据值
     * @param excel 数据注解
     * @return 返回处理后的数据值
     */
    public String dataFormatHandlerAdapter(Object value, Excel excel) {
        try {
            Object instance = excel.handler().newInstance();
            // 获取处理方法
            Method formatMethod = excel.handler().getMethod("format", Object.class, String[].class);
            // 调用处理方法获取对应的处理后的数据值
            value = formatMethod.invoke(instance, value, excel.args());
        } catch (Exception e) {
            log.error("不能格式化数据: {}, 异常信息为: {} ", excel.handler(), e.getMessage());
        }
        return Convert.toStr(value);
    }

    // ========================================================== 将响应数据集导入 excel 表单 ============================================

    /**
     * 对 list 数据源将其里面的数据导入到 excel 表单
     *
     * @param response  返回数据
     * @param list      导出数据集合
     * @param sheetName 工作表的名称
     */
    public void exportExcel(HttpServletResponse response, List<T> list, String sheetName) {
        exportExcel(response, list, sheetName, StringUtils.EMPTY);
    }

    /**
     * 对 list 数据源将其里面的数据导入到 excel 表单
     *
     * @param response  返回数据
     * @param list      导出数据集合
     * @param sheetName 工作表的名称
     * @param title     标题
     */
    public void exportExcel(HttpServletResponse response, List<T> list, String sheetName, String title) {
        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        response.setCharacterEncoding("utf-8");
        // 初始化
        this.init(list, sheetName, title, Excel.Type.EXPORT);
        exportExcel(response);
    }

    /**
     * 对 list 数据源将其里面的数据导入到 excel 表单
     *
     * @param response 响应数据对象
     * @param sheetName 工作表的名称
     */
    public void importTemplateExcel(HttpServletResponse response, String sheetName) {
        importTemplateExcel(response, sheetName, StringUtils.EMPTY);
    }

    /**
     * 对 list 数据源将其里面的数据导入到 excel 表单
     *
     * @param response 响应数据对象
     * @param sheetName 工作表的名称
     * @param title     标题
     */
    public void importTemplateExcel(HttpServletResponse response, String sheetName, String title) {
        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        response.setCharacterEncoding("utf-8");
        // Excel 表单初始化
        this.init(null, sheetName, title, Excel.Type.IMPORT);
        exportExcel(response);
    }

    /**
     * 对 list 数据源将其里面的数据导入到 excel 表单
     *
     * @param response 响应数据对象
     */
    public void exportExcel(HttpServletResponse response) {
        try {
            // 创建写入 Sheet
            writeSheet();
            wb.write(response.getOutputStream());
        } catch (Exception e) {
            log.error("导出 Excel 异常{}", e.getMessage(), e);
        } finally {
            IOUtils.closeQuietly(wb);
        }
    }

    /**
     * 创建写入数据到 Sheet
     */
    public void writeSheet() {
        // 取出一共有多少个 sheet
        int sheetNo = Math.max(1, (int) Math.ceil(list.size() * 1.0 / sheetSize));
        // 遍历 sheet
        for (int index = 0; index < sheetNo; index++) {
            // 创建 Sheet 对象
            createSheet(sheetNo, index);
            // 创建一行
            Row row = sheet.createRow(rowNum);
            // 初始化列数
            int column = 0;
            // 写入各个字段的列头名称
            for (Object[] os : fields) {
                Excel excel = (Excel) os[1];
                // 创建对应的列数据
                this.createCell(excel, row, column++);
            }
            // 导出数据时
            if (Excel.Type.EXPORT.equals(type)) {
                fillExcelData(index);
                addStatisticsRow();
            }
        }
    }

    /**
     * 填充 excel 数据
     *
     * @param index 序号
     */
    public void fillExcelData(int index) {
        int startNo = index * sheetSize;
        int endNo = Math.min(startNo + sheetSize, list.size());
        for (int i = startNo; i < endNo; i++) {
            Row row = sheet.createRow(i + 1 + rowNum - startNo);
            // 得到导出对象
            T vo = list.get(i);
            int column = 0;
            for (Object[] os : fields) {
                Field field = (Field) os[0];
                Excel excel = (Excel) os[1];
                this.addCell(excel, row, vo, field, column++);
            }
        }
    }

    /**
     * 创建统计行信息
     */
    public void addStatisticsRow() {
        // 统计信息判空
        if (!statistics.isEmpty()) {
            // 创建统计行对象
            Row row = sheet.createRow(sheet.getLastRowNum() + 1);
            // 获取统计信息列索引
            Set<Integer> keys = statistics.keySet();
            // 对应的单元格
            Cell cell = row.createCell(0);
            // 设置统计单元格样式
            cell.setCellStyle(styles.get("total"));
            // 对应的值填充
            cell.setCellValue("合计");

            // 填充统计行数据
            for (Integer key : keys) {
                // 单元格索引
                cell = row.createCell(key);
                // 单元格样式
                cell.setCellStyle(styles.get("total"));
                // 单元格数值
                cell.setCellValue(DOUBLE_FORMAT.format(statistics.get(key)));
            }
            statistics.clear();
        }
    }

    // ========================================== 填充 excel 数据补充方法 ========================================

    /**
     * 添加单元格
     *
     * @param attr   注解对象
     * @param row    行对象
     * @param vo     实际对象
     * @param field  属性对象
     * @param column 列数
     */
    public void addCell(Excel attr, Row row, T vo, Field field, int column) {
        Cell cell;
        try {
            // 设置行高
            row.setHeight(maxHeight);
            // 根据Excel中设置情况决定是否导出,有些情况需要保持为空,希望用户填写这一列.
            if (attr.isExport()) {
                // 创建单元格
                cell = row.createCell(column);
                // 设置单元格样式
                cell.setCellStyle(styles.get("data_" + attr.align() + "_" + attr.color()));

                // 用于读取对象中的属性
                Object value = getTargetValue(vo, field, attr);
                // 注解日期格式化方法
                String dateFormat = attr.dateFormat();
                // 注解属性值
                String readConverterExp = attr.readConverterExp();
                // 注解中的分隔符
                String separator = attr.separator();
                // 注解日期格式化方法判空
                if (StringUtils.isNotEmpty(dateFormat) && StringUtils.isNotNull(value)) {
                    cell.setCellValue(parseDateToStr(dateFormat, value));
                } else if (StringUtils.isNotEmpty(readConverterExp) && StringUtils.isNotNull(value)) {
                    // 注解属性值反解析
                    cell.setCellValue(reverseByExp(Convert.toStr(value), readConverterExp, separator));
                } else if (value instanceof BigDecimal && -1 != attr.scale()) {
                    // 属性值为确定精度浮点数值并且注解设置了保留小数位
                    cell.setCellValue((((BigDecimal) value).setScale(attr.scale(), attr.roundingMode())).toString());
                } else if (!attr.handler().equals(ExcelHandlerAdapter.class)) {
                    // 注解属性值调用格式转换方法获取值
                    cell.setCellValue(dataFormatHandlerAdapter(value, attr));
                } else {
                    // 设置列类型
                    setCellVo(value, attr, cell);
                }
                // 添加统计信息
                addStatisticsData(column, Convert.toStr(value), attr);
            }
        } catch (Exception e) {
            log.error("导出 Excel 失败{}", e.getMessage(), e);
        }
    }

    /**
     * 获取 bean 中的属性值
     *
     * @param vo    实体对象
     * @param field 属性字段
     * @param excel 注解对象
     * @return 返回最后的属性值
     */
    private Object getTargetValue(T vo, Field field, Excel excel) {
        try {
            // 获取属性的对象类
            Object object = field.get(vo);
            // 注解对象属性判空
            if (StringUtils.isNotEmpty(excel.targetAttr())) {
                // 获取注解对象的属性
                String target = excel.targetAttr();
                // 是否包含指定字符
                if (target.contains(".")) {
                    // 根据指定分隔符分割属性数组
                    String[] targets = target.split("[.]");
                    // 遍历属性数组
                    for (String name : targets) {
                        // 获取对应的属性值
                        object = getValue(object, name);
                    }
                } else {
                    // 直接获取属性值
                    object = getValue(object, target);
                }
            }
            return object;
        } catch (Exception exception) {
            log.error("获取 bean 中的属性值异常: {}", exception.getMessage(), exception);
        }
        return null;
    }

    /**
     * 以类的属性的 get 方法方法形式获取值
     *
     * @param object 实际属性对象
     * @param name   属性名称
     * @return 返回指定类对象对应属性的属性值
     */
    private Object getValue(Object object, String name) {
        try {
            // 对象判空|属性名称判空
            if (StringUtils.isNotNull(object) && StringUtils.isNotEmpty(name)) {
                // 属性对象类
                Class<?> clazz = object.getClass();
                // 获取指定的声明属性
                Field field = clazz.getDeclaredField(name);
                // 强制访问
                field.setAccessible(true);
                // 获取对应的值
                object = field.get(object);
            }
            return object;
        } catch (Exception e) {
            log.error("以类的属性的 get 方法方法形式获取值异常: {}", e.getMessage(), e);
        }
        return null;
    }


    /**
     * 设置单元格信息
     *
     * @param value 单元格值
     * @param attr  注解相关
     * @param cell  单元格信息
     */
    public void setCellVo(Object value, Excel attr, Cell cell) {
        // 字符串
        if (Excel.ColumnType.STRING == attr.cellType()) {
            // 将属性值转为字符串
            String cellValue = Convert.toStr(value);
            // 对于任何以表达式触发字符 =-+@ 开头的单元格，直接使用tab字符作为前缀，防止CSV注入
            if (StringUtils.startsWithAny(cellValue, FORMULA_STR)) {
                cellValue = RegExUtils.replaceFirst(cellValue, FORMULA_REGEX_STR, "\t$0");
            }
            cell.setCellValue(StringUtils.isNull(cellValue) ? attr.defaultValue() : cellValue + attr.suffix());
        } else if (Excel.ColumnType.NUMERIC == attr.cellType()) {
            // 数值类型 - 判空
            if (StringUtils.isNotNull(value)) {
                cell.setCellValue(StringUtils.contains(Convert.toStr(value), ".") ? Convert.toDouble(value) : Convert.toInt(value));
            }
        } else if (Excel.ColumnType.IMAGE == attr.cellType()) {
            // 图像类型
            ClientAnchor anchor = new XSSFClientAnchor(0, 0, 0, 0, (short) cell.getColumnIndex(), cell.getRow().getRowNum(), (short) (cell.getColumnIndex() + 1), cell.getRow().getRowNum() + 1);
            String imagePath = Convert.toStr(value);
            if (StringUtils.isNotEmpty(imagePath)) {
                // 获取指定路径下的图片二进制数据集
                byte[] data = ImageUtils.getImage(imagePath);
                getDrawingPatriarch(cell.getSheet()).createPicture(anchor,
                        cell.getSheet().getWorkbook().addPicture(data, getImageType(data)));
            }
        }
    }

    /**
     * 获取画布
     *
     * @param sheet Excel sheet 表格
     */
    public static Drawing<?> getDrawingPatriarch(Sheet sheet) {
        // 对应的画布判空
        if (sheet.getDrawingPatriarch() == null) {
            sheet.createDrawingPatriarch();
        }
        return sheet.getDrawingPatriarch();
    }

    /**
     * 获取图片类型,设置图片插入类型
     *
     * @param value 图片二进制数据集
     */
    public int getImageType(byte[] value) {
        // 获取文件类型
        String type = FileTypeUtils.getFileExtendName(value);
        if ("JPG".equalsIgnoreCase(type)) {
            return Workbook.PICTURE_TYPE_JPEG;
        } else if ("PNG".equalsIgnoreCase(type)) {
            return Workbook.PICTURE_TYPE_PNG;
        }
        return Workbook.PICTURE_TYPE_JPEG;
    }

    /**
     * 合计统计信息
     *
     * @param index  列数
     * @param text   属性值
     * @param entity 注解对象
     */
    private void addStatisticsData(Integer index, String text, Excel entity) {
        // 注解对象判空|注解对象是否设置了统计信息
        if (entity != null && entity.isStatistics()) {
            Double temp = 0D;
            // 统计信息是否包含指定列数
            if (!statistics.containsKey(index)) {
                statistics.put(index, temp);
            }
            try {
                // 将属性值转为对应的统计信息
                temp = Double.valueOf(text);
            } catch (NumberFormatException e) {
                log.error("将属性值转为对应的统计信息异常: {}", e.getMessage(), e);
            }
            statistics.put(index, statistics.get(index) + temp);
        }
    }

    // ===============================================================================================================

}
